home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / comm / conex61d.zip / CONEX.DOC next >
Text File  |  1992-03-17  |  21KB  |  702 lines
  1.  
  2.  
  3.                A Quick Reference
  4.  
  5.  
  6.                CONEX VERSION 6.2
  7.  
  8.                    07-11-1991
  9.  
  10.  
  11.             Copyright (C) 1991 Erhard Hilbig
  12.  
  13.  
  14.  
  15. CONEX (latin connection) is used to communicate between IBM personal
  16. computer and a mainframe or between 2 IBM PC's.
  17.  
  18. These are the highlights of the program:
  19.  
  20.  -  The IBM PC can be used as terminal via COM1 - COM4, via Interrupt 14,
  21.     DECNET LAT, FTP TCP/IP and B&W TCP/IP at a mainframe.
  22.  
  23.  -  Parameters like baudrate (50-115200), parity, full/half duplex,
  24.     xon/xoff or hardware handshake can be set in CONEX.
  25.  
  26.  -  Files can be transfered without protocol, e.g. to save a session to
  27.     disk.
  28.  
  29.  -  Several DOS commands can be used inside CONEX, such as "dir", "cd",
  30.     "del" or a DOS shell can be entered.
  31.  
  32.  -  All incoming characters can be sent to a printer.
  33.  
  34.  -  Files can be transfered to and from the mainframe via KERMIT
  35.     protocol.
  36.  
  37.  -  Tektronix 4010/4014 and DEC VT102 can be emulated. The crosshair in
  38.     GIN mode can be moved by a mouse.
  39.  
  40.  -  Graphical output can be displayed on a HPGL plotter or transfered to
  41.     other programs.
  42.  
  43.  -  Up to 10 pages of screen output can be scrolled back to screen and
  44.     edited.
  45.  
  46.  -  All keys including the numerical keypad can be programmed.
  47.  
  48.  -  Incoming characters from the port can be remapped by the user.
  49.  
  50.  -  The configuration of CONEX can be saved to an ASCII file, which can
  51.     be protected by a password or CONEX can be patched by itself.
  52.  
  53.  -  Several sessions, especially net session, can be opened concurrently.
  54.  
  55.  -  CONEX is completely written in assembler and therefore very quick
  56.     and small. The only file necessary to run CONEX is "conex.exe".
  57.  
  58.  
  59.  
  60.             *======================*
  61.             |  How to start CONEX  |
  62.             *======================*
  63.  
  64. Simply start CONEX version 6.1 with
  65.  
  66.         conex [host name|number] [options]
  67.  
  68. parameters
  69. ----------
  70.  
  71. host name   - connect to name of host in a network
  72.           (must have been set with Alt-I before!)
  73. host number - enter session 0 - 9 (default: 0)
  74.  
  75.  
  76.  
  77. options
  78. -------
  79.  
  80. /i<filename> - load different ini file (default: conex.ini)
  81.  
  82.  
  83.  
  84.                *================*
  85.                |  DOS Commands  |
  86.                *================*
  87.  
  88. DOS commands can be executed nearly at any time using the alternate keys.
  89.  
  90.  
  91.  
  92. => Alt-D(irectory) - list directory
  93.  
  94.    When asked for "Dir mask:" you can enter filenames using wild cards ?
  95.    and *, e.g. you get all files ending with .asm if you enter "*.asm".
  96.    You can scroll the filenames using the cursor keys.
  97.  
  98.    If you are to enter a filename e.g. with "Alt-E" or "S" in kermit
  99.    mode, you can switch to this screen with "page up/down". Multiple
  100.    files may then be selected with the keys "INS" or "DEL" or a single
  101.    file simply with "Return".
  102.  
  103.  
  104.  
  105. => Alt-C(hange directory) - Change to another drive/directory
  106.  
  107.    You can change to a new drive by adding "<drive>:" to your pathname.
  108.  
  109.  
  110.  
  111. => Alt-E(rase)  - Erase file
  112.  
  113.    Wild cards cannot be used when entering the filename, but you can
  114.    switch to a selection menu with "Page up/down".
  115.  
  116.  
  117.  
  118. => Alt-X (eXecute) - execute DOS commands
  119.  
  120.    Any valid DOS commands can be executed. But if you want to enter the
  121.    DOS shell completely give "Return". You return to CONEX with "exit".
  122.  
  123.  
  124.  
  125.              *===================*
  126.              |  Port Parameters  |
  127.              *===================*
  128.  
  129. => Alt-I - Initialize connection
  130.  
  131.    The following parameters can be modified
  132.  
  133.    Host:       name of the host to which you are connected. It is only
  134.            important if you are working on a network with LAT,
  135.            PC/TCP or BW/TCP.
  136.  
  137.    Port:       Com, interrupt 14, LAT, PC/TCP or BW/TCP
  138.  
  139.    Portnumber: 1, 2, 3, 4 (only COM/Int 14)
  140.  
  141.    Baudrate:   50, 75, 150, 200, 300, 600, 1200, 1800, 2400, 3600, 4800,
  142.            9600, 19200, 38400, 57600, 115200 (only COM/Int 14)
  143.  
  144.    Bits/parity:7 space, 7 even, 7 odd, 7 mark, 8 odd, 8 even, 8 none
  145.  
  146.    Stopbits:   1, 2 (only COM/Int 14)
  147.  
  148.    Duplex:     half, full
  149.  
  150.    Handshake:  none, hardware, xon/xoff (only COM/Int 14)
  151.  
  152.    Prompt:     You can enter the prompt of the connected machine here.
  153.            When you enter "return" in "edit mode" all characters
  154.            following this prompt are transmitted.
  155.  
  156.  
  157.  
  158.    NOVELL offers interrupt 14 as a link to its programs, so you can use
  159.    it to connect in a NOVELL net.
  160.  
  161.    LAT (Local Area Transport) is used to connect PC and mainframe via
  162.    DECNET. A resident program called "lat" must be loaded before using
  163.    this option. LAT is contained in DECnet-DOS which is available from
  164.    DEC (Digital Equipment Corporation). This software has been tested
  165.    with DECnet-DOS version 2.1.
  166.  
  167.    With PC/TCP you can make a telnet connection on ethernet. The PC/TCP
  168.    kernel ("ethdrv") from FTP Software Inc. must be loaded before, it is
  169.    not public domain. The program has been tested with version 2.04/2.05.
  170.    PC/TCP is a registered trademark of
  171.  
  172.       FTP software, Inc.           anonymous file server
  173.       26 Princess Street           vax.ftp.com (128.127.2.100)
  174.       Wakefield, MA 01880
  175.       (617) 246-0900
  176.  
  177.    BW/TCP has the same features as PC/TCP. The internet number can be
  178.    entered directly as hostname or the hostname can be resolved with a
  179.    hosts file. Enter its location in Alt-Y. Hostname resolution with a
  180.    name server is not supported.
  181.    BW/TCP is a product from Beame & Whiteside Software Ltd.
  182.  
  183.       Beame & Whiteside Software Ltd       Tel + Fax:
  184.       P.O. BOX 8130               (416) 648 6556
  185.       Dundos, Ontario
  186.       CANADA
  187.       L9H 5E7
  188.  
  189.  
  190. => Alt-S - Save all current parameters or Patch conex
  191.  
  192.    The parameters are normally written to the file "conex.ini" and are
  193.    automatically read again when you start CONEX. If you select a
  194.    different name as save file you have to activate it with the command
  195.    line option "/i<filename>".
  196.  
  197.    The following parameters are saved: port parameters (Alt-I), packet
  198.    parameters (kermit mode C-command), vt100-emulation (Alt-M), graphics
  199.    enabled (Alt-G), plot parameters (Alt-P) and status line (Alt-L) in
  200.    the different sessions 0 ... 9 and the keyboard macros. The save file
  201.    is an ASCII file which can be altered by a normal editor, see
  202.    "tech.ref" for more details. It can also be encrypted with a
  203.    password especially to protect the keyboard macros.
  204.  
  205.    Replacing the ini-file by the exe-filename (normally "conex.exe") will
  206.    save parameters to conex.exe itself. Afterwards the INI-file is not
  207.    automatically read, lest you force CONEX to read it with the /i-option.
  208.    Password protection is not supported then.
  209.  
  210.  
  211. => Alt-0..9 - change to another session
  212.  
  213.    Up to 10 different network session can be opened concurrently
  214.    depending on the limit of the resident network software. Port and
  215.    kermit parameter can be set differently in each session, the screen
  216.    is saved and restored, too. These sessions can be directly selected
  217.    with Alt-0 to Alt-9.
  218.  
  219.  
  220. => Alt-N(ame) - change to another session with host name
  221.  
  222.    All sessions are listed and can be selected with the cursor keys.
  223.    Open sessions in a network are marked with an arrow.
  224.  
  225.  
  226.  
  227. => Alt-B(reak) - send break
  228.  
  229.    Sends a break over the serial line (short break), if Alt-B ist
  230.    pressed twice, the signals RTS and DTR are dropped for a short time
  231.    (long break). These commands are normally used to interrupt the
  232.    connection between mainframe and PC. In the networks NOVELL, DECNET
  233.    or TELNET a break is sent according to network standards.
  234.  
  235.  
  236.  
  237.             *======================*
  238.             |  Terminal Emulation  |
  239.             *======================*
  240.  
  241.  
  242. The PC can be used as a normal terminal. The folling modes can be
  243. selected with function keys:
  244.  
  245.  
  246.  
  247. => F7 - normal mode
  248.  
  249.    All input characters are immediately sent to the mainframe.
  250.  
  251.  
  252.  
  253. => F8 - edit mode, scroll back
  254.  
  255.    In this mode the screen can be scrolled back and modified with the
  256.    cursor keys (home, end, left, right, up, down, page up/down, del,
  257.    ins, ctrl-end = delete to end of line). You can scroll back up to 10
  258.    screen pages. You can enter this mode with shift+cursor keys, too.
  259.  
  260.    With "return" the cursor line is sent to the mainframe and CONEX is
  261.    switched back to normal mode. If a prompt has been defined with Alt-I
  262.    for this session it is stripped off. With ESC or F7 you return to
  263.    normal mode without transmitting anything.
  264.  
  265.  
  266.  
  267. => F9 - kermit mode
  268.  
  269.    Kermit must be started on mainframe to transfer files. (see below)
  270.  
  271.  
  272.  
  273. => Alt-M - change emulation, character set
  274.  
  275.    The PC behaves like a DEC VT102 terminal when it receives ESC
  276.    commands. Some keys send different code: function keys F1 - F4, cursor
  277.    keys, + key = return key on DEC terminal, the numerical keypad. The
  278.    keys "page up/down", "ins", "del", "home" and "end" send codes of an
  279.    VT202 terminal.
  280.  
  281.    Character set 1 (characters 33-127) can be selected from ASCII, UK,
  282.    graphic, german and user. Character set 2 (characters 128-255) can be
  283.    selected from multinational and user. User character set is defined
  284.    in CONEX.INI.
  285.  
  286.  
  287.  
  288. => Alt-L - change status line
  289.  
  290.    You can select from the following items: 1. normal status line, 2.
  291.    empty status line, 3. status line with column numbers, 4. no status
  292.    line. The selection can be saved with Alt-S.
  293.  
  294.  
  295.  
  296. => Alt-H - Help
  297.  
  298.    This gives a list of all possible commands in CONEX, of modified
  299.    keys and last not least my address. Keys which have been replaced by
  300.    a single key are marked with an arrow.
  301.  
  302.  
  303.  
  304.  
  305. => F10 - quit CONEX
  306.  
  307.    DTR and RTS can be dropped when you leave the program. If you changed
  308.    any parameters you are asked to save them. Network connections are
  309.    always closed.
  310.  
  311.  
  312.  
  313. => Ctrl-backspace = DEL, Ctrl-return = LF
  314.  
  315.    One of the unknown facts is that DEL (127) and LF (10) can be
  316.    produced this way.
  317.  
  318.  
  319.  
  320. => Ctrl-NUM LOCK or PAUSE
  321.  
  322.    Stop output to screen, any other key resumes output to screen again.
  323.    This command is executed by the normal keyboard device driver.
  324.  
  325.  
  326.  
  327.               *==================*
  328.               |  Graphic Screen  |
  329.               *==================*
  330.  
  331. The program can switch automatically into graphic mode when it
  332. receives a graphic commands and behave as a tectronix 4010 or 4014. The
  333. following graphic cards are supported: hercules, CGA, EGA and VGA.
  334. The graphic card is automatically detected on entry to CONEX.
  335.  
  336.  
  337.  
  338. => F5 - enter graphic mode
  339.  
  340.    The screen is switched into graphic mode. Some keys like Alt
  341.    combinations will not work any more in this mode.
  342.  
  343.  
  344.  
  345. => Alt-G - enable graphic mode
  346.  
  347.    When a graphics command GS, FS, US or ESC ENQ, ESC FF, ESC SUB is
  348.    received CONEX will automatically switch into graphic mode. You can
  349.    switch back to normal by pressing F7.
  350.  
  351.    In GIN mode the crosshair can be moved using the cursor keys; the
  352.    shift key speeds up this movement. If a Microsoft compatible mouse is
  353.    connected and the mouse driver loaded you can move the crosshair with
  354.    the mouse as well.
  355.  
  356.  
  357.  
  358. => Alt-P - Write plot file
  359.  
  360.    The graphics can be written to a file in HPGL format and plotted on a
  361.    HPGL compatible plotter later on. Pagewidth, margins and velocity of
  362.    the pen can be selected as well.
  363.  
  364.  
  365.             *======================*
  366.             |  Writing Key Macros  |
  367.             *======================*
  368.  
  369.  
  370.  
  371. => Alt-K - Write key macro
  372.  
  373.    All keys can be programmed, if they are detected by BIOS (Int 11h)
  374.    calls. Characters in a macro are sent out at a rate of 10
  375.    character/sec.
  376.  
  377.    The following keys have special meanings in programming:
  378.  
  379.    F1      begin command character, here displayed as "<"
  380.    F2      end command character, here displayed as ">"
  381.    F3      seperation character in commands, here displayed as "|".
  382.    F4      enter function, alt, control keys literally
  383.       press F4 followed by special key
  384.  
  385.    ■IN0   virtual keys which must be entered using F4,I,N,#.
  386.    ...      When a new connection is opened the corresponding macro
  387.    ■IN9   IN# is automatically started. On com ports a new connection
  388.       is determined from the presence of DTR and CTS.
  389.  
  390.  
  391.    The following combinations have special meanings in macros:
  392.  
  393.    <W#>
  394.     Wait for # seconds. # = 1...9
  395.  
  396.    <R<string1> | <string2> | ...>
  397.     Wait until the mainframe sends <string1> or <string2> or ... The
  398.     strings must be seperated with key F3 "|".
  399.  
  400.    <D#1 | #2 | ...>
  401.     Dial telephone number #1, if it is occupied try next number #2
  402.     ... The special string sent before or after the phone number
  403.     must be set with Alt-Y, especially prefix (string before
  404.     number), suffix (string after number) and connect|fail (answer
  405.     of mainframe if connected or connection failed).
  406.  
  407.  
  408.    - Labels are ignored if you replace a key by a single key.
  409.    - A memory region of 10000 bytes is reserved for keyboard macros.
  410.    - During the execution of a macro inputs from the keyboard can be
  411.      done, only ESC stops the macro.
  412.  
  413.  
  414. => Alt-Y - configuration of CONEX
  415.  
  416.    You can enter strings to dial a telephone number and page length
  417.    of printer which is activated by Ctrl + Print Screen. The dial
  418.    sequence is preset to Hayes modem.
  419.  
  420.  
  421.  
  422.           *==========================================*
  423.           |  Transfer of Files without any Protocol  |
  424.           *==========================================*
  425.  
  426.  
  427.  
  428. => Alt-W - write file
  429.  
  430.    Use this command to save all incoming characters to a file either to
  431.    remember what you were doing or to transfer files. The transfer may
  432.    be interrupted with the Alt-W.
  433.  
  434.  
  435.  
  436. => Alt-R - read file
  437.  
  438.    The file is transfered to the mainframe as it is, especially CR and
  439.    LF at end of line are sent. The transfer can be interrupted with
  440.    Alt-R.
  441.  
  442.  
  443.  
  444. => Control + Print Screen - print incoming characters
  445.  
  446.    All incoming characters are transfered to the printer. If a page
  447.    length is defined with Alt-Y, the printed pages will be numbered.
  448.    Pressing Control+Print Screen twice produces a form feed and page
  449.    numbering begins anew.
  450.  
  451.  
  452.  
  453.           *=================================*
  454.           |  Transfer Files in Kermit Mode  |
  455.           *=================================*
  456.  
  457. You must start kermit on the mainframe and enter "server", "receive" or
  458. "send", then press F9 to enter local kermit mode to start the file
  459. transfer.
  460.  
  461.  
  462.  
  463. => I(nit parameter) P(acket)
  464.  
  465.    These parameters determine how the data packet will be build and
  466.    normally need not be altered.
  467.  
  468.    packet length - length of a packet including packet number, type and
  469.     checksum. (default 94)
  470.  
  471.    padding character - characters sent before any packets to synchronize
  472.     transmission. (normally not necessary)
  473.  
  474.    quote control character - control character are quoted with this
  475.     character, Control-A is coded as '#A'. (default #)
  476.  
  477.    quote 8-bit character - characters whose 8th bit is set are quoted
  478.     with this character, hex A8 is coded as &H. (default &)
  479.  
  480.    repeat character - 8 characters 'HHHHHHHH' is shortened to 3
  481.     characters ~'H, 8 is coded as '. (default ~)
  482.  
  483.    type of checksum - CONEX supports 3 kinds of checksums, which consist
  484.     of 1, 2 or 3 bytes. (default 1)
  485.  
  486.    packet terminator - Every packet is terminated with this character.
  487.     (default = CR)
  488.  
  489.  
  490.  
  491.  
  492. => I(nit parameter) C(ommon)
  493.  
  494.    ASCII/binary file type - Binary files (files with characters over 127)
  495.       should be transfered with file type binary. The mainframe must be
  496.       set to this mode, too, normally with "set file_type binary".
  497.       Sometimes binary files can also be transfered with "parity none",
  498.       which is quicker.
  499.  
  500.    Repeating - repeated characters are compressed in a packet. (see
  501.       repeat character)
  502.  
  503.    Max number of retries - number of trials to resend a packet, which
  504.       has been refused by the mainframe.
  505.  
  506.    Time out in secs - If the PC did not answer for the specified time
  507.       the last packet is resend.
  508.  
  509.  
  510.  
  511. => S(end) - send files
  512.  
  513.    Multiple files seperated with blanks and "wild cards" can be entered.
  514.    If you want to select from a file list, press "page up/down" and
  515.    select with "ins" or "del".
  516.  
  517.  
  518.  
  519. => R(eceive) - receive files
  520.  
  521.    This command is used to get files from the mainframe. If this file
  522.    already exists on the PC the old one is renamed to ".bak".
  523.  
  524.    If the sender has already been told the name of the file ("send
  525.    foo"), simply press return when asked for "receive file". It is also
  526.    possible to enter "wild cards" which are understood by kermit at the
  527.    mainframe.
  528.  
  529.  
  530.  
  531. => T(race) - handles output of packets to screen
  532.  
  533.    trace errors - display all error packets on screen
  534.    trace all    - display all packets on screen
  535.  
  536.  
  537.  
  538. => F(inish) - terminate server on the mainframe
  539.  
  540.    Kermit on the mainframe is terminated and CONEX changes back to
  541.    normal mode.
  542.  
  543.  
  544.  
  545. => L(ogout) - terminate session on the mainframe
  546.  
  547.    Like "finish" but terminate session, too.
  548.  
  549.  
  550.  
  551. => cursor keys
  552.  
  553.    Scroll the messages at the bottom of the screen.
  554.  
  555.  
  556.  
  557. => C(hange directory) - change directory on the mainframe
  558.  
  559.    This and the following commands only work, if kermit on the
  560.    mainframe supports generic commands.
  561.  
  562.  
  563.  
  564. => D(irectory) - list directory on the mainframe
  565.  
  566.  
  567.  
  568. => E(rase) - erases file on the mainframe
  569.  
  570.  
  571.  
  572. => N(ame) - rename file on the mainframe
  573.  
  574.  
  575.  
  576. => U(sage) - query disk usage
  577.  
  578.  
  579.  
  580. => M(essage) - send a short message
  581.  
  582.  
  583.  
  584. => Q(uery server) - query server status
  585.  
  586.  
  587.  
  588. => During a file transfer the following commands can be used.
  589.  
  590.    ESC - interrupts transmission completely. This should be the last
  591.      resort if nothing else works.
  592.  
  593.    ^T  - change trace mode (= "T" in main menu)
  594.  
  595.    ^F  - interrupts the transfer of current file, the transmission
  596.      proceeds with the next file.
  597.  
  598.    ^G  - interrupts file transfer completely.
  599.  
  600.    @   - enter debug mode: trace is set on; packets are only transmitted
  601.      if a key is pressed
  602.  
  603.    CR  - resend last packet, if transmission stopped
  604.  
  605.  
  606.              *====================*
  607.              |  error characters  |
  608.              *====================*
  609.  
  610.  
  611. Some characters, which are output to screen, have special meanings:
  612.  
  613. Blinking character  - Parity or Framing error: A bad character was received.
  614.               Alter bits/parity, if all characters are blinking.
  615.  
  616. rubout (dec 178)    - Overrun error at COM port. Too many characters have
  617.               been received at the port.
  618.  
  619. up arrow (dec 24)   - Sender time out: Characters could not be sent out.
  620.               In a network environment the connection is
  621.               interrupted.
  622.  
  623. down arrow (dec 25) - Receiver time out: Characters could not be received
  624.               from remote host. The connection is interrupted.
  625.  
  626.  
  627.  
  628.                  *============*
  629.                  |    Problems  |
  630.                  *============*
  631.  
  632. 1. Interrupt numbers >7 on COM have not been tested.
  633. 2. Characters in Tektronix mode are not transmitted to HPGL file.
  634.  
  635.  
  636.                *===============*
  637.                |  Past history |
  638.                *===============*
  639.  
  640. 6.0   1st Public Domain Version in comp.binaries.ibm.pc
  641.  
  642. 6.1   default COM3/4 Interrupt = 4 and 3
  643.       COM3/4 Interrupt + IO address configurable
  644.       up to 4 LAT sessions
  645.       ESC FF, ESC SUB, ESC ENQ automatically switch into graphic mode (Alt-G)
  646.       support extended keyboard (esp. F11, F12)
  647.       rotate interrupts configurable in conex.ini
  648.       format of CONEX.INI changed!!!
  649.       dial sequences are saved in CONEX.INI
  650.       start initial macro at 1st opening of a session (Alt-K, ■IN#)
  651.       characters from port can be remapped (Alt-M, character set: user)
  652.       conex can be patched (Alt-S, file name: conex.exe)
  653.       support B&W TCP/IP (Alt-P)
  654.       ESC stops macros only in normal or graphics mode
  655.       alphabetically sorted output in directory listing
  656.       alphabetically sorted output of macros in help screen
  657.       multinational supplement character set implemented
  658.       ESC ENQ supported in graphics mode
  659.       hercules graphic screen increased to 720 X 360 pixels
  660.  
  661. 6.2   default setting changed to bits/parity: 8 none, emulation: VT100
  662.       single key replacement shown with Alt-H
  663.       default kermit packet size = 2000 bytes (long packet)
  664.  
  665.  
  666.                *================*
  667.                |  Future plans  |
  668.                *================*
  669.  
  670. - more rows, columns on EGA/VGA card
  671. - FTP file transfer
  672. - direct access to packet drivers
  673. - emulate tektronix 41XX (I am looking for a description!! Send me a Mail.)
  674. - support kermit larger packet size
  675. - support other file transfer protocols
  676.  
  677.  
  678.  
  679.                   *==========*
  680.                   |  Author  |
  681.                   *==========*
  682.  
  683.     Erhard Hilbig
  684.     Hochschulrechenzentrum
  685.     Universitaet-Gesamthochschule Paderborn
  686.     Postfach 1621
  687.     W-4790 Paderborn (Germany)
  688.  
  689.     e-mail: zahilb@pbhrzt.uni-paderborn.de
  690.     phone: 05251/60-2433           room: N2-316
  691.     FAX:   05251/60-3207
  692.  
  693.  
  694.       This program has been developed by me and can be distributed
  695.      freely. There is also a more detailed documentation in german
  696.      available, which is written in LaTeX. You can have it as LaTeX
  697.     DVI file or as a print file, which must be output using
  698.             "copy conex.lst prn/b".
  699.  
  700.     If you find any bugs or have an idea how to improve the program,
  701.                send me a message!
  702.